home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d22 / fac23.arc / FAC.DOC next >
Text File  |  1990-11-07  |  22KB  |  443 lines
  1.                            ╥─────╥      ╥      ╥─────╥
  2.                            ║           ║ ║     ║
  3.                            ╟────╢     ╟───╢    ║
  4.                            ║         ║     ║   ║
  5.                            ╨         ╨     ╨   ╨─────╨
  6.  
  7.                           Fantastic  Attribute  Changer
  8.                          ───────────────────────────────
  9.  
  10.                                    Written by
  11.  
  12.                                    Mike Viens
  13.                                 (C)opyright 1990
  14.                                   Version 2.3s
  15.  
  16.                             Electronic Illusions BBS
  17.                1200 - 2400 Bauds  Supporting MNP Level 5 and v.42
  18.  
  19.          ┌──┐ ┌──┐ ┌──┐        ┌──┐ ┌──┐ ┌──┐        ┌──┐ ┌──┐ ┌──┐ ┌──┐
  20.          ┌──┘ │  │    │  ────  ├──┤    │ ┌──┘  ────  ├──┐  ──┤ ┌──┘ ├──┤
  21.          └──┘ └──┘    ┴        └──┘    ┴ └──┘        └──┘ └──┘ └──┘ └──┘
  22.  
  23.  
  24.                                 ╒══════════════╕
  25.                                 │  Disclaimer  │
  26.                                 ╘══════════════╛
  27.  
  28.    MichaelSoft makes no warranty of any  kind,  either  express  or  implied,
  29.    including  but  not  limited  to implied warranties of merchantability and
  30.    fitness for a particular  purpose,  with  respect  to  this  software  and
  31.    accompanying documentation.
  32.  
  33.    IN NO EVENT SHALL MichaelSoft BE LIABLE FOR ANY DAMAGES (INCLUDING DAMAGES
  34.    FOR  LOSS  OF  BUSINESS  PROFITS,  BUSINESS INTERRUPTION, LOSS OF BUSINESS
  35.    INFORMATION, OR OTHER PECUNIARY  LOSS)  ARISING  OUT  OF  THE  USE  OF  OR
  36.    INABILITY TO USE THIS PROGRAM, EVEN IF MichaelSoft HAS BEEN ADVISED OF THE
  37.    POSSIBILITY OF SUCH DAMAGES.
  38.  
  39.  
  40.  
  41.                                 ╒══════════════╕
  42.                                 │  Trademarks  │
  43.                                 ╘══════════════╛
  44.  
  45.    Fantastic Attribute Changer is a trademark of MichaelSoft.
  46.  
  47.  
  48.  
  49.                                  ╒═════════════╕
  50.                                  │  Shareware  │
  51.                                  ╘═════════════╛
  52.  
  53.     FAC is being  distributed  under  a  unique  marketing  method  known  as
  54.     Shareware.  The  Association  of Shareware Professionals (ASP) offers the
  55.     following definition of Shareware:
  56.  
  57.           Shareware distribution gives users a chance to try software
  58.           before  buying  it.  If  you  try  a  Shareware program and
  59.           continue using it, you are expected to register. Individual
  60.           programs differ on details  --  some  REQUEST  registration
  61.           while  others  REQUIRE  it,  some  specify  a maximum trial
  62.           period. With registration, you get anything from the simple
  63.           right to continue using the software to an updated  program
  64.           with printed manual.
  65.  
  66.           Copyright  laws  apply  to  both  Shareware  and commercial
  67.           software, and the copyright holder retains all rights, with
  68.           a  few  specific  exceptions  as  stated  below.  Shareware
  69.           authors  are accomplished programmers, just like commercial
  70.           authors, and the programs are of  comparable  quality.  (In
  71.           both cases, there are good programs and bad ones!) The main
  72.           difference  is  in  the  method of distribution. The author
  73.           specifically grants the right to copy  and  distribute  the
  74.           software, either  to all and sundry or to a specific group.
  75.           For example, some authors require written permission before
  76.           a commercial disk vendor may copy their Shareware.
  77.  
  78.           So, Shareware is a  distribution  method,  not  a  type  of
  79.           software.  You  should  find software that suits your needs
  80.           and pocketbook, whether it's commercial or  Shareware.  The
  81.           Shareware  system  makes fitting your needs easier, because
  82.           you can try before you buy. And  because  the  overhead  is
  83.           low,  prices  are  low  also.  Shareware  has  the ultimate
  84.           money-back guarantee -- if you don't use the  product,  you
  85.           don't pay for it.
  86.  
  87.  
  88.  
  89.                                ╒════════════════╕
  90.                                │  Registration  │
  91.                                ╘════════════════╛
  92.  
  93.    Registration licenses you to use FAC.  Any  unregistered  use  other  than
  94.    trial  use  to  determine  if  FAC  meets your needs is a violation of our
  95.    license agreement and is forbidden.
  96.  
  97.    Single user registration is available  for  $10.00  per  copy.  Registered
  98.    users  will be sent the most current version of the program.  Registration
  99.    also entitles you to free phone support, except toll-call charges.  If you
  100.    are a Shareware author and have a program I may be interested in, maybe we
  101.    can swap registrations.  Let me know what you have.
  102.  
  103.    The FAC license authorizes use of one copy of FAC  on  one  machine  at  a
  104.    time.  If  you have multiple computers, either stand-a-lone, networked, or
  105.    multi-user, you need to register one copy of FAC for each  workstation  on
  106.    which it will be used.
  107.  
  108.    For registration and licensing of more than  ten  copies,  please  contact
  109.    MichaelSoft  directly  at  (207)  872-2425  for  details  on  our quantity
  110.    discounts and site licensing arrangements.
  111.  
  112.    FAC is NOT, never has been, and never will be free.  If  you  use  it  for
  113.    more  than  two  weeks  from  the  date  you obtain it, YOU MUST REGISTER.
  114.    Shareware should and can work only with your  help.  With  all  the  hours
  115.    that  I  have  put  in  getting FAC to work correctly, and based on what I
  116.    charge per hour as a computer consultant, this program probably would cost
  117.    you  about  $1500.  I  am  only  asking  for  Ten ($10).  You also will be
  118.    mailed notice of improvements to FAC.
  119.  
  120.  
  121.  
  122.                                ╒════════════════╕
  123.                                │  Distribution  │
  124.                                ╘════════════════╛
  125.  
  126.    FAC may be freely distributed as long as no charge is required  to  obtain
  127.    it  and as long as all files in this ZIPped file are all in original form.
  128.    Any modification to FAC or its accompanying files is strictly  prohibited.
  129.    If  you  find FAC or any of its files not in tact, report it to me as soon
  130.    as possible.  Tell me where you got it, when you got it and what is  wrong
  131.    with  it.  I  can't  and  won't  be  responsible  for the integrity of FAC
  132.    when you receive it.  When FAC leaves MichaelSoft, it runs correctly  with
  133.    no damaging or destructive results.
  134.  
  135.    If any Shareware distributor wants to distribute FAC, or any product  that
  136.    is  copyrighted  by MichaelSoft, your company MUST contact me directly and
  137.    tell me you wish to do so and obtain specific written permission.
  138.  
  139.  
  140.  
  141.                               ╒═══════════════════╕
  142.                               │  For the curious  │
  143.                               ╘═══════════════════╛
  144.  
  145.    FAC was written with Borland's Turbo Pascal 5.5.  I only  used  the  units
  146.    CRT  and  DOS.  Any  serious  questions about my programming techniques, I
  147.    will be glad to answer, however, I will not give out source code!  You may
  148.    contact  me  via  my BBS or by writing to me at the address below.  FAC is
  149.    comparable to a program that comes  with  Norton's  Utilities  called  FA,
  150.    which  stands for File Attribute.  FAC has more features, and runs faster.
  151.    On my hard drive, I have 56  different  sub-directories  and  1175  files.
  152.    I  had  each program go through every sub-directory and list the attribute
  153.    for every file.  FAC also  will  change  the  attribute  bits  on  a  sub-
  154.    directory, and  printed  them  as well, where FA cannot perform this.  FAC
  155.    finished in 12 seconds where FA took 19 seconds.  FAC can also  print  the
  156.    Size,  Date  and Time of files and does this upon default.  The above test
  157.    was without this option.  With this option, FAC took 14 seconds.  Clearly,
  158.    FAC is superior to FA.  Sorry Peter!
  159.  
  160.  
  161.  
  162.                                ╒════════════════╕
  163.                                │  Requirements  │
  164.                                ╘════════════════╛
  165.  
  166.    To use FAC, you need at least DOS 3.0 and AT  LEAST 60K  of  memory  free.
  167.    FAC  may  be  accessed  via DOS's PATH command.  A color monitor is highly
  168.    recommended but  not  necessary  to  run  FAC.  A  monochrome  version  is
  169.    available if you register.
  170.  
  171.  
  172.  
  173.                                ╒════════════════╕
  174.                                │  Introduction  │
  175.                                ╘════════════════╛
  176.  
  177.    I wrote FAC because I needed it.  FAC allows you to change the  attributes
  178.    of  a  group  of  files.  If  told  to, FAC  also will search through sub-
  179.    directories.  This utility is very fast and  very  powerful.  Of  all  the
  180.    attribute  changer  programs I have seen, not one offered all the features
  181.    I wanted, so FAC was born.  For  those  of  you  who  may  not  know  what
  182.    attributes are, there are four: Archive, Read-Only, System and Hidden.  If
  183.    a file has the Archive bit set, this means the file has been changed since
  184.    the last time it was backed up.  If a file has the Read-Only bit set, this
  185.    means the file can be read, but  not  written  to, meaning  it  CANNOT  be
  186.    changed.  If  a  file  has the System bit set, it means this file is a DOS
  187.    System file and should be left alone.  If a file has the Hidden  bit  set,
  188.    then  you  cannot see the file or directory by using the DIR command.  You
  189.    can still  run  the  file, assuming  it  is  executable, or  go  into  the
  190.    directory, it  is just hidden.  You now know what attributes are, but what
  191.    do they do?  Have you ever seen a file on your disk, and wanted to  delete
  192.    it, but  DOS  gave  you  the  message  "ACCESS DENIED"?  On  that file, an
  193.    attribute was set that marked the file as a  Read-Only  file, meaning  you
  194.    can read from it, but can't write to it.  Since deleting the file would in
  195.    fact write to it, actually over it, DOS will not  let  you.  Use  FAC, and
  196.    unset  the  Read-Only attribute.  You also may have some Hidden files that
  197.    you never knew you had.  FAC will find them for you.
  198.  
  199.  
  200.  
  201.                               ╒═══════════════════╕
  202.                               │  Getting started  │
  203.                               ╘═══════════════════╛
  204.  
  205.    FAC can search through your directories for files as well.  It has a limit
  206.    of  200 directories it can handle.  I feel that this is more than adequate
  207.    for anyone.  If it isn't, you will need to register and tell me  how  many
  208.    directories  you  have.  I  will give FAC room for more than the number of
  209.    directories you have to allow you to  add  more.  Type  FAC ?  to  receive
  210.    the help screen.
  211.  
  212.    FAC can be fine-tuned to perform special functions  via  a  command  line.
  213.    The  command  line  should  be in the format of FAC Filespec ATTR Options.
  214.    The order of the parameters is not important since FAC knows what to  look
  215.    for.  Filespec  is  any  legal  filename  or  wildcard:  *.*  or *.zip  or
  216.    a*.zi?  are all considered legal.  If no Filespec is  given, than  *.*  is
  217.    assumed.  There  are  44  characters  you cannot use in a filename and FAC
  218.    checks for them and will abort if one is found.  ATTR are  the  attributes
  219.    you   want  to  set  or  unset.  Values  are  +ARSH  or  -ARSH.  The  only
  220.    distinguishing markers are the + and - signs, so  they  MUST  be included.
  221.    The available Options parameters are:
  222.  
  223.          /A  -->  Files with at least the Archive bit set
  224.          /C  -->  Clear all bits (same as -ARSH)
  225.          /D  -->  Change bits on sub-directories
  226.          /F  -->  Files only - Size, Date and Time are not displayed
  227.          /H  -->  Files with at least the Hidden bit set
  228.          /P  -->  Pause every page
  229.          /R  -->  Files with at least the Read-Only bit set
  230.          /S  -->  Process files in sub-directories
  231.          /T  -->  Display totals of files found and changed
  232.          /U  -->  Unusual files - those with any bit set
  233.          /Y  -->  Files with at least the System bit set
  234.  
  235.    /A will search for files with at least the Archive bit set, although there
  236.    may be other bits set as well.
  237.  
  238.    /C clears all the bits from a file.  You can use the parameter of -ARSH to
  239.    accomplish this, I just added this to make it easier.
  240.  
  241.    /D will allow the changing of bits on a sub-directory.  The only bit  that
  242.    will affect it is the Hidden bit.  You can hide or unhide a sub-directory.
  243.    FAC will allow you to change the other three bits as well if you want.
  244.  
  245.    /F will stop the Size, Date and Time of the file(s) from being  displayed.
  246.    They are displayed by default.
  247.  
  248.    /H will search for files with at least the Hidden bit set, although  there
  249.    may be other bits set as well.
  250.  
  251.    /K will kill (delete) all files that are found.  Use this command with  or
  252.    without  the /V command.  If a sub-directory is found, it will be skipped,
  253.    not deleted.  FAC was not meant to be a directory  killer.  I  am  in  the
  254.    process of writing one though.  Look for FDKxx.ZIP.
  255.  
  256.    /P will pause the output every page, which I set for 24  lines.  After  24
  257.    lines  have  gone by, a "pause prompt" will appear on line 25.  The prompt
  258.    allows you to hit N for non stop listing, Q or ESC to quit and  return  to
  259.    DOS  and  the sub-directory in which you started from or hitting any other
  260.    key will continue for another 24 lines or until the  end, whichever  comes
  261.    first.
  262.  
  263.    /R will search for files with at least  the  Read-Only  bit  set, although
  264.    there may be other bits set as well.
  265.  
  266.    /S allows searching from the CURRENT sub-directory and all sub-directories
  267.    below it for files.
  268.  
  269.    /T will display totals after all files have been found.  It  will  display
  270.    the total number of files found and files changed.
  271.  
  272.    /U will find any unusual files.  These are files with any  bit  set.  This
  273.    is similar to the /A command.
  274.  
  275.    /V will verify that you want to delete each file.  This is  used  with  /K
  276.    only and has no other meaning if /K is not used.  The file will  be  shown
  277.    as normal and  you  will  be  shown  a  prompt  "Delete? (Y/N/C/Q)"  minus
  278.    the  quotes.  Hit 'Y' to delete the file and FAC will show you that it has
  279.    been deleted.  Hit 'N' and the file is not deleted.  Hit 'C' for continous
  280.    deleting  from this point on without verification.  Hit 'Q' or ESC and the
  281.    file will not be deleted and you will immediately be returned to  DOS  and
  282.    the sub-directory in which you started from.
  283.  
  284.    /Y will search for files with at least the System bit set, although  there
  285.    may be other bits set as well.
  286.  
  287.    At anytime while FAC is running, you can hit ESC and it  will  immediately
  288.    return  to  DOS  and the sub-directory at which you started from.  Another
  289.    key you can hit while FAC is running is P, which immediately puts FAC into
  290.    Pause mode, the same as if you used /P option.
  291.  
  292.  
  293.                               Sample command lines
  294.                               ────────────────────
  295.  
  296.    C>fac                 Will display the attributes for  all  files  in  the
  297.                          current directory
  298.  
  299.    C>fac /cspt a*.zi?    Will search for files in the  current  sub-directory
  300.                          and  all sub-directories below that start with A and
  301.                          have ZI in the extension.  It will clear all bits on
  302.                          those  files  and display a total of files found and
  303.                          files changed.
  304.  
  305.    C>fac /us             Will search for files in the  current  sub-directory
  306.                          and  all sub-directories below it for files with the
  307.                          Archive bit set.
  308.  
  309.    C>fac fre*.* -a /kv   Will search for files in the  current  sub-directory
  310.                          and  start with FRE and have any extension.  It will
  311.                          clear the Archive bit and Verify that  you  want  to
  312.                          Kill the file.  This command could actually be doing
  313.                          2 functions at once.  Say you  want  to  delete  one
  314.                          file with the FRE*.* and just remove the Archive bit
  315.                          of another.  By using the  Verify  command, you  can
  316.                          tell FAC which one to delete.
  317.  
  318.    As you can see, the command line is very flexible and  it  doesn't  matter
  319.    where  the  parameters  are on it.  Again, if no Filespec is given, *.* is
  320.    assumed.  DO NOT TRY A COMMAND LINE LIKE THIS:
  321.  
  322.    C>fac b:*.txt -a
  323.  
  324.    If you want to manipulate files on another drive, then go to  that  drive,
  325.    don't  try to tell FAC to go there.  This is not to say that FAC.EXE can't
  326.    be somewhere, let's say in a sub-directory called C:\UTILS.  Assuming that
  327.    C:\UTILS is in the current PATH, then type:
  328.  
  329.    C>b:
  330.  
  331.    B>fac *.txt -a
  332.  
  333.  
  334.  
  335.                          ╒═════════════════════════════╕
  336.                          │  Registered Version of FAC  │
  337.                          ╘═════════════════════════════╛
  338.  
  339.    The registered version of FAC  will  be  identical  in  operation  to  the
  340.    shareware  version.  The  only  difference  is  there  will  be no message
  341.    telling you to hit a key after all the files have  been  processed.  There
  342.    also  will not be a "goodbye" screen telling you to register.  The size of
  343.    FAC.EXE will be smaller  as  a  result  of  this.  If  you  would  like  a
  344.    monochrome version of FAC, you must register.
  345.  
  346.  
  347.  
  348.                                  ╒═══════════════╕
  349.                                  │  Bug Reports  │
  350.                                  ╘═══════════════╛
  351.  
  352.    While I think I have gotten all the bugs in FAC, there may still be  some.
  353.    I  would appreciate it if you find one, you will let me know.  Include the
  354.    version of FAC you have, ALL information about your computer system,  what
  355.    is  wrong  or happening that makes you think there is a bug and your name,
  356.    address, and phone number.  Send it to the address below.
  357.  
  358.  
  359.  
  360.                               ╒═══════════════════╕
  361.                               │  Custom Software  │
  362.                               ╘═══════════════════╛
  363.  
  364.     I will, at my discretion, write custom  software  for  you.  Also, at  my
  365.     discretion, I will allow you to pick the language you want it written in.
  366.     Your choices  are  Turbo  Pascal  5.5, QuickBasic  4.5  and  QuickC  2.0.
  367.     Depending on how big the project is, that will MOSTLY determine if I will
  368.     write it for you.  The more complicated the program, the harder it is  to
  369.     write.  In all cases, the finished product is a copyright of MichaelSoft.
  370.     You may purchase the source code for your use only, but MichaelSoft  will
  371.     still own the program.  You may not, without prior written authorization,
  372.     sell the source code or  a  finished  product  of  MichaelSoft.  You  may
  373.     purchase  the  rights to any program I write for you and MichaelSoft will
  374.     give up all claims to that program.  Direct any inquiries to the  address
  375.     below.
  376.  
  377.  
  378.  
  379.                                  ╒════════════╕
  380.                                  │  Versions  │
  381.                                  ╘════════════╛
  382.  
  383.     Version 1.0s  -  Initial release on 08/08/90.
  384.  
  385.     Version 1.1s  -  Fixed bug when using the /T option that gave  the  wrong
  386.                      number of files changed.  Released on 08/13/90.
  387.  
  388.     Version 1.2s  -  Fixed bug when changing attributes on  a  directory, FAC
  389.                      would  display  the directory  as  having the attributes
  390.                      changed, although would not do  it.  This  only  implies
  391.                      when NOT using the /D switch.  Reduced the size  of  the
  392.                      EXE file by optimizing the code.  Released on 08/18/90.
  393.  
  394.     Version 1.3s  -  Optimized the code making FAC.EXE  smaller  and  faster.
  395.                      Released on 08/21/90.
  396.  
  397.     Version 1.4s  -  Optimized the again making FAC.EXE smaller.  Released on
  398.                      08/27/90.
  399.  
  400.     Version 1.5s  -  Added /H, /R and /Y options  to  the  command  line  and
  401.                      optimized small portion of code.  Released on 09/06/90.
  402.  
  403.     Version 1.6s  -  Added /F option to the command line and added the  Size,
  404.                      Date  and  Time  of  the file(s) being displayed.  Added
  405.                      error checking for the Filespec.  Released on 09/08/90.
  406.  
  407.     Version 1.7s  -  Added /K and /V options to the command  line.  Optimized
  408.                      a small portion of code.  Released on 09/14/90.
  409.  
  410.     Version 1.8s  -  Optimized lots of little areas of  code  making  FAC.EXE
  411.                      smaller  and  faster.  Also added the ability for FAC to
  412.                      use a math co-processor if one  is  available.  Released
  413.                      on 09/19/90.
  414.  
  415.     Version 1.9s  -  Fixed a small bug when FAC found a  sub-directory  while
  416.                      using the /K option.  Released on 10/03/90.
  417.  
  418.     Version 2.0s  -  FAC will no longer the clear the screen at  startup  and
  419.                      optimized  the code making FAC.EXE smaller.  Released on
  420.                      10/10/90.
  421.  
  422.     Version 2.1s  -  Optimized several small portions of code and  fixed  bug
  423.                      when  ANSI or equivalent was not loaded, and FAC aborted
  424.                      due to some  error  such  as  a  bad  filename  or  user
  425.                      aborted, the DOS prompt would not be reset to the normal
  426.                      grey color.  I still don't know why this was  happening,
  427.                      but it is fixed.  Released on 10/30/90.
  428.  
  429.     Version 2.2s  -  Added routine that turns the cursor  off  while  FAC  is
  430.                      running  and  is restored after completion.  Released on
  431.                      11/02/90.
  432.  
  433.     Version 2.3s  -  Optimized some code making FAC.EXE smaller  and  faster.
  434.                      Released on 11/08/90.
  435.  
  436.  
  437.     I may be reached at:
  438.  
  439.          Mike Viens
  440.          276 Main Street  Apt. 1
  441.          Waterville, Maine  04901
  442.          (207)872-2425 Voice - from 5:00pm to 10:00pm EST
  443.